🍇 ChaiTrace — Guide de démarrage

Ce guide existe en ligne dans 26 langues : studio-lr.fr/installer-chaitrace.html
This guide is online in English and 24 other languages: studio-lr.fr/en/installer-chaitrace.html

✅ Rien à installer. Tout ce dont ChaiTrace a besoin est dans ce dossier : vous l'ouvrez, et le logiciel démarre. Comptez quelques minutes pour la première fois.

Version bêta. ChaiTrace sert chaque jour au chai depuis juillet 2026, et chaque mise à jour l'améliore. Au moindre problème, écrivez à lubin.rocher@studio-lr.fr : je vous réponds sous 24 heures.

Démarrer le logiciel

1Rangez le dossier ChaiTrace-Premium sur l'ordinateur du chai

Par exemple dans vos Documents ou sur le Bureau. Évitez de travailler depuis une clé USB : vos données seraient enregistrées sur la clé.

2Double-cliquez sur ChaiTrace Premium

La première fois, Windows affiche deux messages :

« Windows a protégé votre ordinateur » : cliquez sur « Informations complémentaires », puis sur « Exécuter quand même ». Ce message s'affiche pour les logiciels récents, que Windows ne connaît pas encore ; il ne signale pas de problème.
Une question du pare-feu sur « Node.js JavaScript Runtime », le moteur de ChaiTrace : cliquez sur « Autoriser l'accès » pour que les tablettes et les téléphones du domaine puissent s'y connecter.

Le logiciel s'ouvre ensuite dans sa propre fenêtre, comme n'importe quelle application. Pour quitter, fermez la fenêtre : tout s'arrête proprement.

💡 Pour un raccourci sur le Bureau : clic droit sur ChaiTrace Premium → « Envoyer vers » → « Bureau (créer un raccourci) ».

3Activez le logiciel avec votre nom et votre clé

Au premier lancement, ChaiTrace demande le nom et la clé d'accès (format CHAI-XXXX-XXXX-XXXX) affichés sur la page de votre inscription. Les accents et les majuscules du nom ne comptent pas. Cette étape n'est demandée qu'une fois : la clé se lie à cet ordinateur.

Vous n'avez plus la page de votre inscription ? Écrivez à lubin.rocher@studio-lr.fr : je vous renvoie votre clé.

ℹ️ Vos données restent sur cet ordinateur. Une connexion à Internet est nécessaire pour activer la clé, puis au moins une fois par semaine pour la revérifier : sans contact pendant 7 jours, le logiciel se met en pause jusqu'à la prochaine connexion, sans rien perdre.

Premiers pas dans le logiciel

Au premier lancement, ChaiTrace propose une visite guidée, sur un domaine d'entraînement ou sur le vôtre. Créez ensuite, dans l'ordre :

Référentiels → votre campagne (millésime) et vos appellations ;
Parcelles → vos parcelles (nom, surface, cépage, appellation) ;
Chai → Contenants → vos cuves et barriques ;
Œnologie → Produits → vos produits œnologiques et leur stock.

Vous pouvez ensuite créer votre premier lot à partir des tickets de vendange. Le guide complet d'utilisation est dans le fichier NOTICE.md.

En cas de problème

Le logiciel ne s'ouvre pas depuis l'archive
Décompressez d'abord l'archive : clic droit sur ChaiTrace-Premium.zip → « Extraire tout… ». ChaiTrace doit rester dans son dossier, à côté des dossiers runtime, server, public et data.

Le navigateur ne s'ouvre pas tout seul
Ouvrez votre navigateur vous-même et tapez dans la barre d'adresse : localhost:8124, puis appuyez sur Entrée.

Utiliser le logiciel depuis une tablette
La tablette doit être sur le même Wi-Fi que l'ordinateur, et ChaiTrace ouvert sur l'ordinateur. Pour connaître l'adresse à taper sur la tablette, lancez une fois Lancer ChaiTrace Premium.bat : la fenêtre noire affiche la ligne « Depuis une tablette : http://192.168… ». Si la tablette n'arrive pas à se connecter, lancez Autoriser-acces-reseau.bat (clic droit → « Exécuter en tant qu'administrateur »).

Autre chose
Écrivez à lubin.rocher@studio-lr.fr : je vous réponds sous 24 heures.

💾 Sauvegarder vos données

Tout ce que vous saisissez est enregistré immédiatement dans le fichier data\chai.db, à l'intérieur de ce dossier, et ChaiTrace en fait une sauvegarde automatique chaque jour. Gardez aussi une copie récente de ce fichier sur une clé USB ou un disque externe : c'est votre sécurité si l'ordinateur tombe en panne. Pour restaurer, remettez votre copie à la place du fichier, logiciel fermé.

Mises à jour

Elles sont comprises dans l'abonnement. Quand une nouvelle version paraît, ChaiTrace l'annonce au bas de sa barre latérale ; le mode d'emploi est sur studio-lr.fr/mettre-a-jour-chaitrace.html. Vos données ne sont jamais touchées.